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AUTOMATING ASSOCIATION IMPLEMENTATION IN C++ 

by David M. Papurt 
. David compares several unidirectional and bidirectional pointer-based methods, for 
implementing orie-to-one associations: a direct, handwritten implementation, a modulai 
approach exploiting inheritance, and template-based implementations. ■ 

OBJECT-ORIENTED FACrLITIES IN ADA 95 

by David L. Moore 

With the adoption of the ISO/ANSI Ada -95 standard, Ada supports object-oriented 
programming features such as class-wide objects, private types and child packages, 
multiple inheritance, and more. 

PARTIAL REVELATION AND MODULA-3 

by Steve Freeman ■ 

When compared to strongly typed languages, Modula-3 gives you greater flexibility iti 
class reuse. Steve examines Modula-3's type system and describes How you can take 
advantage of its power. ' . ■ ' 

OBJECT-ORIENTED PROGRAMMING IN S 

by Richard Calaway : . . 

S," a high-level, objeGt<)riented language, was originally designed for data analysis and 
graphics, A$ Richard points put, however, the S language 'is useW for a wide range of 
applications. - : 

COBOL '97: A STATUS REPORT 

by Henry Saade and Anri Wallace 

The proposed Cobol '97 standard includes object-oriented features such as class 
definition, subclassing, data encapsulation, and polymorphism: Our authors focus on 
the objectK)riehted extensions to Cobol, and cover other proposed features. 





FILE-STREAMING CLASSES IN C++ 

by Kirit Saelensminde 

Kirit implements a C++ file-streamiiig system that, unlike MFC or OWl, doesn't require a 
common superclass. This approach leads to less overhead and greater portability. 

INSIDE MFC SERIALIZATION 

by Jim Beveridge 

The Microsoft Foundation Class Library implements a typesafe serialization mechanism 
that is both fast and flexible. Jim takes an in-depth look. at how this mechanisni works — . 

and examines how you can get the most out of it. - 
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EMBEDDED SYSTEMS 



INSIDE FLASH MEMORY 

by Brian L Dipert 

Direct-execute flash memory systems don't require the gigabyte hard disks and 64-Mbit 
DRAM an-ays common in desktop systeins. 
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MEIWORKED SYSIEMS 



ENVIRONMENT VARIABLES AND WINDOWS 3.1 

by John (Fntz) Lotvrey 

Nothing can give network admuiistrators a headache like several hundred networked 
computers which need to run software that demands customized nin-tinie environments. 
To make the job even more difficult, using a single environment space in the Windows 
system area for all programs is dangerous, not to mention that environment handling - 
under Windows 3.1 is poorly documented. . 

EXAMINIHG ROOM , 

EXAMINING CA-VISUAL OBJECTS 

by Rod da Silvu 

CA-Vi.sual Objects is an apphcation-^development environment that sports an 
incremental, native-code compiler, visual painters and editors, an advanced, active, 
repositoiy-based storage system, and an ob)ectK)nented language that allows for 
optional sirong typing and full object onentation. 

P ROGRAM MER'S WORKBENCH 

POWERBUILDER NVOs 

by Mark Robinsun 

Quite possibly, Non-Visual User Objects (NVOs) are PowerBuilder's most useful tool for 
eteaung true ob)ecl-onented applications. Mark examines the effective use of NVOs and 
their role in apphcation development. 

COLUMNS 

PROGRAMMING PARADIGMS 

by Michhel Sivaiiie 

Michael takes a look at Sun's Hotjava Web browser^ as well as Java, the prpgiaiamning 
,e it was wifitten in. 



CPROGRAMMING 

by Al Stevens ' _ - 

Al wraps up "MidiFitz," a Windows-based C++ prograni that uses IVIIDI to emulate a jazz 
prano player's rhythm section in real lime. MidiFitz examines the liotes being played,' 
deduces a musical chord, and plays a bass line through the MIDI system. 

ALGORITHM ALLEY 

edited by Bruce Schneier 

This month, Louis Plebaiii examines search procedures that enable you to obtain the 
common fraction approximation of real niJrnbers. In doing so, he focuses on ntirtiber 
theories such as Farey Sequences. 

PROGRAMMER'S BOOKSHELF 

byRayValdes 

A good C++ book can be hard to find. Ray looks at some of the better ones. 
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by Michael Swaine 
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OF INTEREST 

by Monica E. Berg 

SOURCE CODE 
AVAIIABIIITY 
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As a service to our readers, all source • 
code is available on a single disk and 
online: To order the disk, send $14.95 
(Califomii residents add sales tax) to Dr. 
Dobb's Journal, 4U^6Te\ AS/e., Sin 
Mateo, CA 94402, call 415^55-4100 x5701, 
or use your credit card to order by fax, . 
425-358-9749. Specify issue number add 
disk format! Code is also available through 
the DDJ Forum on CompuServe (type GO 
DDJ), via aiiOnymous FTP from site 
ftp.mv.com (192.80.84.3) in the /pub/ddj ' , 
directory; on the World Wide Web at 
http://www,ddj.com, and through DDJ 
Online, a free service accessible via direct 
dial at 415-358'8857 0200/2400/9600 
baud, 8-N-l). 



NEXT MONTH 



From the front cover to the back page, 
we'll be covering client/server 
architectures in our November issue. 
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Inside MFC 
Serialization 



Typesafe serialization 
that's fast and flexible 

Jim Beveridge . 

•jl g aving seen several commercial soft- 
& «' ^^"^^ packages chrgugh complete lilc 
ii^lK: cycles, I am reluctant to*rely on 
1 u "black-box" solutions, winch tend to 
break down as a package evolves and be- 
comes more complex. When I first saw the 
serialization mechanism in the Microsoft 
Foundation Classes (MFC), I questioned 
whether it was robust and flexible enough 
for a commercial application. 1 discovered 
that, although it has 'limitations, the serial- 
ization mechanism in MFC is strongly 
grounded in modern, object-oriented de- 
sign theory. Furthermore, it is typesafe and 
leaves room for your design to evolve. 

Using MFC serialization is straightfor- 
ward, By default, any class derived from 
. CObject can include a SerializeQ mem- 
ber function that takes a CArchtve as a 
parameter. In this member function, you 
add your own code to save and load any 
data associated with your class. 

Data is serialized to and from a CArchive 
with opemtor.<< and operator», much 
like iostream. The big difference is that 
CArchive IS strictly a binary data format. 
As in iostream, there are default imple- 
mentations that read and write funda- 
tnental data types such as long and char. 
The absence of the data type int facilitates 
portability between l6- and 32- bit imple- 
mentations: Tlie default implernentatioiiis 
also handle byte swapping for types that 
. support it. (For more information dn porta- 
bility between Little- and Big-endian ar- 
diitectures, sete "Endiars-Neutiral Software," 



Jim, a software developer at Turning Point 
Software, can be contacted at ftmb®turn- 
tngpoint.com. ' 



by James R. Gillig, DZy, October/Novem. 
ber 1994.) . , 

MFC's implementation seemed obvious 
and uninteresting until the day 1 created 
multiple docuiTKnt types in the same ap- 
plication. At that point, I noticed that 
whenever I loaded a file, MFC would cor- 
rectly create the right kind of docunient 
object and call the proper SerializeC) 
mernber function. This happened in spite 
of the fact that I had not written any code 
to help MFC create these document types. 
Or so I thought.... 




Problems, Problems Everywhere 

To create a document or any .other kind 
of object on the fly, MFC needs to solve 
three problems: 



Problem 1. Aitttraiy types miist be cre- 
ated as needed, but the new operator can 
only create an explicit type, so a form of 
"virtual constructors" for CObject is nec-' 
essary. 

Problem 2. Developers need to be able 
to easily add new classes to be created. 
Ideally, this would be done in the class 
definition and/or implementation. 

Problem 3- A mapping scheme is need- 
ed to allow a particular type to be creat-' 
ed based on information read from a file. 
This mapping cannot be hardcoded in 



MFC because developers add new types 
all the time. 

As you'll see, MFC solves these prob- 
lems elegantly with the' use of a registiy 
with automatic type registration and an 
implementation of virtual constructors 
based on these registered types. MFC's 
ain^time type infornialion is a biiilding 
block for this architecture. 

The Type Registry 

To handle nin-tinie type information, MFC 
creates a registiy of classes in the appli- 
cation that are derived {mm CObject. Tills 
has notliing to do with tlie OLE registr\-, 
but the concept is similar. The type reg- 
isuy is a linked list of CRuntimeClass strvic- 
tures, in which each enti7 describes a 
CO&yec^ derived class in the application. 
Listing One shows the CRuntimeClass 
stmcture (listings begin on page 122): 

The real magic is that the types in this 
registiy are not hardcoded in any table, 
The first clue. to how this trick is accom- 
plished is at tlie top of SCRIBDOC.H from 
the MFC "Scribble'' sample application. 
The beginning of the class declaration 
looks like Example 1(a). 

The online help says to use the DE- 
CLARE^DYNCREATE macro to enable ob- 
jects of CObject^denvQd classes to be cre- 
ated dynamically at am time. Although this 
is a concise description of what DE- 
CLARE^DYNCREATE does, what really goes 
on inside tlie macro is far more interesting. 
After preprocessing, the DECLARE_DYN- 
CREATE macro exparids to several new 
class members; see' Example 1(b). (Note 
that all examples are from MFC 3.1 and 
Visual C++ 2.1. I've reformatted all pie- 
processorrgenerated code for readability.) 

Tlie GetRimtimeCiass()v\mz\ function 
is the basis for run- time types in MFC. 
Runtime type infonnation can be accessed 
for any COfoyec/- derived object that in- 
cludes DECLARE_DY]SiAMIC, DECLARE,, 
DYNCREATE, or DECLARE_SERIAL. This 
infoimation lets you determine if an ob- 
ject can legally be "downcast" to a derived 
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(continued from page 62) 
class or if oiie object is the same class as 
another. Although Visual C++' does hot 
support the new C++ operator dyndmic_ 
cast, using this run-time type information 
will achieve the same effect. 

The run-time type infornriation is de^ 
clared using a static member variable, iii 
this cas6 classCScribDoc. The name (which 
has no space) is created, in the various 
DECLARE_xxx macros with the macro- 
concatenation operator. Both ^GetBase- 
CldssO and GetRuntitneClassO are used 
to access this nin-time class information. 
GetRuntimeClassC ) is virtual, so the type 
of an object can be found even with a 
pointer to a generic CObject. 

Finally, the Constnict() static member 
function forms the basis of MFC's use of 
its class registiy as a class factory that can 
create arbitrary types on deniand. To un- 
derstand the workings of ConstructO, 
some background is hdcessary. 

Creoting dh Object 

Iri Advanced C**: Progrdmming Styles 
and Idiom (Addison-Wesfey, 1992), James 
O. Coplien describes the concept of a vir- . 
tual constructor: ' 

The virtual constaictor is used when the • 
type of an object heeds to be determined ■ 
from the context in which the object is " 

constaicted, . . • 

In MFC, the context is based on infor- 
mation read from a serialized archive. How- 
evef, a virtual constiTictor is only a con- 
cept; ho language construct implements it 
directly. The new operator requires an ex- 
plicit class as its arguhiSht. Virtual con- 
structors can be created by implementing 
in each class a static function that calls 
neiu. This static member function can be 
called when a pailicular type is needed. 

In MFC, this member function is called 
ConstructO. It is created by the IMPLE- 
MENT_DYNCREATE or IMPLEMENT_SE- 
RIAL macros. One of these macros must 
. appear exactly once in, a .cpp rhodule for 
. each Glass supporting dynamic creation. 



In Scribble, the IMPLEMENTJDYNGREATE 
(CScribDoc, CDoeufneht ) statement ap- 
pears near the top of SCRIBDOC.CPP. The 
first argument is the class, and the second 
is the class's parent class. Listing Two is 
the code gefierated by the preprocessor. 

When MFC needs a document or any 
other CO^/ecf- derived type, it calls the 
CreateOly'ectO meitiber function for an in- 
stance of a CRuntimeClass. CreateObjecK) 
allocates the iriemory using this size in the 

The type registry is 
a linked list of 
CRuntimeClass 
structures 

CRuntimeClass structure, then calls CoH- 
' structObfectC). . ConstructObjeCt verifies that 
the type supports dynatnic Construction, 
theh calls the Con^/mc/O function. 

Although no explanation is given in the 
soiirces, this arrangement cleanly separates 
the construction of an object from the mem- 
ory allocation. This seems like a lot of ex- 
tra work, but it is required uhder certain 
■ circumstances. For example, if an array 
were created manually, the memory would 
have to be created with a single mdllocO 
in order to be contiguotis. By Using Con- 
■structObjectG, you could manually initial- 
■ize each array entry. This mechanism al- 
lows decisions horftially made tiii C++ at 
compile time to be made at run time. 

Example 2 shows the ConstructO func- 
tion. The syntax of tlie call to new is a lit- 
tle unusual. The function actually called is 
CObject: :operator fiewCsizeJ, void*). Re- 
member, the size of a structure is an im- 
plied argument when operator new is called, 
but must be explicitly declared in the op- 
erator new definition. This version of new 
in CObject does noxYmg, but calling new 
has the side effect of calling the construc- 



tor for this object. Again; the memory was i 
already allocated by CreateObfect using the 
size inforrhation in CRuntimeClass. 

By using the registry of CRuntimeClctsses 
and the ConstructO member function, 
MFC is able to lookup and create new 
types on the fly, which solves Problem 1. 
A potentially serious problem with this 
technique is that multiple inheritance and 
virtual base classes are not supported (see 
MFC Technical Note #l6). 

Type Registration 

Problem 2 is that users must be able to 
easily add new classes into the i^egistry. 
The idea of types registering themselves 
is core to object-oriented design. If a type 
registers its own existence with a registry 
instead of hardcoding the type into the 
registry, then the type can be freely added 
and removed from the program without 
any code changes to the registry. 

Although not immediately obvious, it is 
the IMPLEMENT.DYNCREATE macro that 
enables users to easily add hew classes 
into the registry. In the expansion of IM- 
PLEME;Nt_DYNCREATE in Listing Two, 
the static in$tance of CRuntimeClass in 
CScribDoc \s initialized as in Example 3 

Sevei^l of these entries have already 
been discussed. In particular, the state- 
ment sizeofCCSctibDoc) is used by Create- 
Object to allocate memory; then the func- 
tion pointed at by CScribDoc: Construct 
initializes the memory. 

The next line places' this information 
into the MFC type registry: static const 
■ AFXj:LASSINITJnU_GScnbDoc(& CScrib- 
Doc::classCScnbDoc);. This declaration 
cohstruGts ati object of type AFX_CLASS- 
INlt using a constructor that lakes a 
CRuntimeClass SiS its argument. Because 
this object is at file, scope, it will be con- 
stmcted before mainO AEXXlASSINIT's 
constructor links this CRuntimeClass into 
the MFC type registry. AFX_CLASSlNIT it- 
self has no member data, so it will not 
take up any data space. 



void _.,stdcall CScribDoc: : Construct 
(void* p) 

{ 

new(p) CScribDoc; 



Example 2: The G6nstruct( ) function. 



CRuntimeClass CScribDoc : : 

classCScribDoc = { 
"CScribDoc" , 

sizeof (CScribDoc) , 
0XFFFF, 

CScribDoc: : Construct, 
SCScribDoc : :j^GetBaseCiass , 
0 ) : 



(a) class CScribDoc : public CDocuinent 
{ 

protected: // create froin serialization only 
CScribDoc (); 

DECLARE..DyNCREATE(CScribDoc) 

); 

(b) protected; 

Static CRuntimeClass* __stdcall _GetBaseClass () ; 

static CRuntimeClass classCScribDoc; 

virtual CRuntimeClass* GetRuntimeClassC ) const; 
static void ^_stdcall Construct (void* p) ; 



' - ■- • — — ; . -- . ... , ..^ . I Example 3^ Initializing the static 

Example 1: (a) fh& beginning of d class declaration; (b) after preprocessing, instance of CRuntimeClass /n 
the DECLARE^DYNGRmiE macro exparic^ to several new class m CScribDoc. 



64 



Dr. Dobb's Journal, October 1995 



PBeEBAMMt RS 

imiaEBDIDXOQI 



l-800-862-728a 

' "nie most convenient and efficient 
mnay to locate and register for 
^Windows' Programmer Training ' 
i 'Cesses nationwide." 

v'The Programmers Training Alliance: is';' 
'•!an association of independent 
r Authonzed Education Centers located , 
an cities throughout the U.S. andJ. 
;; Canada. Every month the Alliance; 
; offers hundreds of hands-on tra niny 
^classes. Classes are available at begin^:-_ 
i>,ner,;mtemnediate, and advanced Ievels7^ 
a Course topics include: 

; •^Windows NT 
'Supporting Windows 95 

• Visual Basic 

• Visual C+ + 
» Access 

• SQL Server . . 
» (MS Mail 

• Lotus Notes 

• Power Builder 

V '[ Novell Netware I 
Borland Delphi { 
1^ ^Oracle Wbrkgroup 1 

%Iust, one call and you're set! Our 
i^Ttalining Consultants will assist withi' 
class selection and provide course.- 
^outlines within minutes. We will locdtc 
s^the-.training center closest to you jrid 
fsfegister you in the class. Gr wc cnn' 
!t5send an experienced instniftor to' 
&;teach on-site at your office. LiMve the 
EJ-work to us. It has never been so 
Sisirnp'le! For more information, call us/ 

!IS'.'30000W Alabama Rodil.Stp 119-200 

>* , ,Alpharetla,Ge(irEia 30202 

• (•"E-Mail 74271.1420 @ compuseive com 

Phone 404-772-0799 
, • BVX 404-772-0354 
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(contmued from page 64) 

This mechanism allows on-lhe-fly reg- 
Lstnition of objea types whenever they are 
linked into the program, thus solving 
Problem I. . 

A common question is. What is the 
difference between tlie various DECLARE 
and IMP1.FMF.NT macros? All DFX":LARE_ 
DYNAMIC and IMPLhMHNT_DYNAMIC 
macros define a static uistance of CRun- 
timeClass similar ro the DYNCREATE 
shown earlier, except that the Construct 
field is NULL. DECLARE_DYNCREATE and 
1MPLEMENT_DYNCREATE add the Con^ 
stnictC ) function for dynamic type creauon. 
f)K IAKb_SFRlAI and 1MPLEMFNT_ 
Si-mAi. build on tlie DYNCREAIli macros, 
and replace the OxFPFF entry with the 
staicturc''.s schema number. . 

fhe SERIAL macros also define opera'- 
lor>> for the class. Ihe operator» re- 
quires s|3eaa! handling because it is called 
witfi a pointer to tlie cla.ss. but no instance 
of the cL'iss will exist until the instance 
has been .senalized in from the file. With- 
out an instance of the cla.ss, MFC cannot 
access the run- time class information to 
ensure that the object being loaded is 
equivalent to or is a derived class of the 
given pointer. By overloading qpera/or», 
MFC is able to pass m a pointer to the 
ain-time type information so that the se- 
rialization mechanism will be typesafe. 

Creating Types from a File 

The third problem is to create a mapping 
scheme to allow a type to he created 
based on infomiation read from a file. Giv- 
en that tlie compiler requires c)a.s.s name.s 
to be unique and that fhe class name is 
already embedded in the CRuntimeClass 
stnicture, the actual class name is the ide-: 
al candidate to write to a file in order to 
identify a class. 

An object could be saved to an archive 
by wnting the class's name and data. MI'C 
does this and a little bit more for each 
da.ss It encounters. The name of the class 
is from the structure s CRuntimeClass, 
winch IS obtained from a virtual function 
in the object. Because the typing is dy- 
namic and (lone at run time, a staicturc 
ot tvpe 77,c;(?rwili be properly written even 
if MFC IS passed a pointer to a base class 
ol tvpe Animal. Uus type safely is iiiit 
porianl. Any function can safely save an 
object to an archive even if the object s 
exact tyj5G is unknown. 

1 he same benefit applies to restoring 
an object from an archive. Going back to 
the example at the beginning of the arti- 
cle, MFC IS able to successfully load the 
correct docunient type from a file with tlie 
sutiple statement in hxainple ^. 

In the implementation (>\ opcrator», 
MhC loads the name of the cla.ss from the 
file, tlien searches the list of types for that 



name. As long as the type exists in the 
registry and was declared with either D£- 
CLARE.DYNCIIEATF or DECLARE^SKR]- 
AL, MFC can construct the object. 1 he ac- 
tual loadmg of the; data appnjpnate to that 
kind of object is delegated to the objea 
Itself by calling its SenaltzeC) virtual mem- 
ber function, and Problem 3 is solved. 

The type of object created is separated 
from the type of object requested. If a de- 
nved class ls loaded into a pointer to a base 
class, as in the example of CDocument, 
then the correct denved class will still he 
created. This is tlie only way that the cor- 
rect vtbl pointer can be set up to point at 
the object's virtual functions. If the obieci 
ui the archive is not a "kind of" the spec- 
ified object, MI'C will tltrow an exception. 

Tlierc are two potential pitfalls here for 
developers, tirst, renaming a serializable 
structure or class will corrupt any old save 
files or archives. Second, MFC does not 
record the length of each object into the 
archive. If MFC can't load an object, it will 
not be able to skip the object and load 
the rest of the archive. 

Optimizing Archives 

When I first scaruted this code, 1 had vi- 
sions of massive bloat in the save file and 
painful delays while the linked list was 
walked repeatedly. Rut MhC keeps its 
arcliive size down and its execution speed 
up by using hashed identifiers. 

MFC keeps a hash table that tracks all 
clas.ses and objects written to an arcluve. 
Once they are written, MhC docs not 
rewnte tliem: it writes an identifier instead. 
Thus, when tlic; archive ls read back in, the 
linked list of types is traversed only for a 
new das,s. For siibsecjuent uistances of the 
class, the proper instance of CRunttmeClass 
will be found with a ha.shed lookup. 

This behavior also means that multiple 
references to the same object are han- 
dled correctly. If objects A and B both 
point to a single instance of object C 
when the archive is created, they will 
both point to a single instance of object 
C when the file is read back in. MFC will 
also correctly resolve circular references 
between objects. 

Tlie impleiTOitation is much faster tlian I 
expected. On a 4S6/66, MFC was able to ,s;ive 
and load an archive over a megabyte long 
with 10,000 sejwijte instances of CArray 
<DWORD,DWORD> in under two seconds. 

An iiTportant lunitation is thai the hash 
table can have no more than 32,766 class- 
es and objects per archive context. This 
count only includes cla.sses denved from 
CObjecl and serialized with opc;rator«, 
not fundamental types such as short and 
long, CString, and CPoint. (See MFC Tech- 
nical Note 2: Persistent Object Data For- 
mal tor more information on how archives 
are constnjcted.) 
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Example 4: Loading the cojrect 
document type from d file. 

Schema Versi ns 

A poorly documented feature in 32-bit MFC 
3.2 is support for versionable schemas, 
where MFC allows the SerializeC) routine 
to haiidle the various versions of the class 
instead Of throwing an exception. This fea- 
ture is very important in an evolving pro- 
ject. Although I will describe how to 
implefilent a versioriable schema,' the irri- 
plernentation is broken in Visual C++ 2.x 
and fails at run tifne. 1 recomnnend telling 
Microsoft how nauch you would like this 
. feature fixed. 

Iri MFC, each structure that uses DE- 
CLAREJERIAL and IMPLEMENT.SERIAL 
lias an associated version number. This 
number is normally set to 1, as shown in 
most MFC sample code; for example, IM- 
PLEMENT^SERlALCCStroke, CObject, 1). 

Each structure or class has its own ver- 
sion nunaberj which can vary indepen- 
dently of the others. MFC automatically 
writes the version number into the arcfiive 
after the class ID. Prior to 3.0, MFC did 
not have a mechanism to completely sup- 
port this version number, so Older versions 
throw an exception if the schema nlim- 
ber of the objea in the file does not match 
tile current schenia number. This inhibits 
support for multiple schemas. 

In MFC 3.0 and later, this behavior is 
only the default, and can be changed. By 
ORing the third parameter of the IMPLE- 
MENT_SERIAL macro with the constant 
VERSIONABLE_SCHEMA, MFC will allow 
you to handle the schema version in your 
SerializeC ) function. For example, to set 
the document version hvimber to 3, spec- 
ify DEClAREJERIAlXCScribDoc, CDocu- 
ment, VERSJONABLE_SCHEMA \3). 

To use this feature, a class should call 
GetObjectSchemaO in its SerializeC) mem- 
ber function when the archive is loaded; 
see Listing Three. 

C nclusion 

By creating a foundation of a run- time 
type mechanism with a class factory and 
building serialization on top of it, MFC 
implements a fast, flexible, typesafe seri- 
alization mechanism. This mechanism 
. should be powerful enough to satisfy most 
design requirements. 



DDj 

(Listings begin on page 122.) 
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SINCE 1979 THE WORLD'S LEADING COMPANIES HAVE 
BUILT THEIR APPLICATIONS WITH OUR TECHNOLOGY 

THE PROFram DBMS 

FOR YOUR NEXT PROJECT CONSIDER FAIRCOM: 
THE BEST PRICE FOR THE BEST PiRFOftMi^NQE 



c-tree Plus* 



ROYALTTFREE HIGH PERFORIWANCE DBMS 

By simply linking with a different c-tree Plus 
library, an application can move frorn a single-user 
applicatlan to a multi-user application, to a 
client-server application, c-tree Plus is distributed 
in corriplete C source code and is known for its 
unparalleled flexibility, portability and royalty-free 
licensing policy. This licensing puts your develop- 
ment budget to work for you, c-tree Plus provides 
"makes" for the follow/ing platforms: DOS [Micro- 
soft G, Borland C, Symantec, and for Zortech C 
and Watcom C. 16/32-bit); Microsoft Windows 
(Microsoft C. Borland CJ; Microsoft NT; 03/2 
(Microsoft C, IBM C/SET, Borland OS/S); Unix; 
QNX (16 and 32^itJ; Coherent; IBM RS6CXX); 
SUN; Motorola B80PEN; HP3000; Xenix; Apple 
Macintosh and DEC Alpha 

COMPLETE "C" SOURCE CODE. 

SltMGLE / MULTI USER 

CLIENT / SEVER (optional) 

FULL ISAM FUNCTIONALITY 

NO ROYALTIES 

TRANSACTION PROCESSING 

FIXED / VARIABLE LENGTH RECORDS 

MULTIPLE KEYS 

DYNAMIC SPACE RECUMATION 
HIGH SPEED DATA / INDEX CACHING 
BATCH OPERATIONS 
UNSURPASSED PORTABILftY 



Server* 



SERVERS SQL & nbn-SOL 

FairCom Servers are available for the following 
platfornhs: DOS/Windows. Windows NT. NLM, 
dS/a, ATS.T Unix, SCO Unix, Interactive Unix. 
QNX; Banyan. HP9000, SUN, Solaris; IBM 
RSBOCX), Motorola 88CPEN, Apple A/UX, 
Apple System 7, DEC Alpha. 
FairCom Servers communicate using NETBIOS, 
SPX/IPX, TCP/IR shared memory, message 
queues or StreetTalk depending on the server 
platfdriTi. Most server platforms support more : 
than one protocol providing you the flexibility to 
choose how your client applications communicate 
to the server. For example, the FairGgm OS/2 
server can comnnunicate with shared rhemory 
and NETBIOS clients at the same time, and most 
of the Unix packages include a shared memory 
and a TCP/IP FairCom Server. 

CLIENT / SERVER MODEL. 

TRANSACn"ION PROCESSING 

HETEROGENEOUS NETWORK 

REQUIRES < 2MB RAM 

ON-LINE BACKUP : ' 

DISASTER RECOVERY 

ROLL BACK - FORWARD 

ANtl-DEADLOGK RESOLUTION ■ 

GLIENT-SIEDE "C" SOURCE 

MULTI-THREADED 

OEM (UPON REQUEST) 



r-tree® 



REPORT GENERATOR 

The r-tree Report Generator handles v 
every aspect of report generation. 

- COMPLETE "C" SOURCE CODE 

- COMPLEX MULTI-LINE REPORTS 

- MULTI-FILE ACCESS 

- COMPLETE LAYOUT CONTROL 

- CONDITIONAL PAGE BREAKS 

- NESTED HEADERS AND FOOTERS 

- DYNAMIC FORMAT SPECIFIC^ATIONS , 

- HORIZONTAL REPEATS 

- AUTOMATIC ACCUMUUTORS 



d-tree~ 



APPLICATION DEVELOPMENT 

d-tree provides the convenience of a 4GL product 
at the C development tool level. 

- COMPLETE "C" SOURCE CODE 
' - PROTOTYPE GENERATION 

- DATA DICTIONARY 

- PORTABLE SCREEN HANDLER • 

- RUNTIME RESOURCE CONTFIOL 

- FLEXIBLE DATA WINDOWS 

- DATA FILE REFORMATTING 

- EASY TO USE DBMS INTERFACE 

- MUCH MUCH MORE 



^ FAIRCOIVI^ 



£800) 
S34-8180 



ELJROPE via Sottocoma 15/17 - 24031 / 



31 - CTALY - rihbtiB 1035) 773-164 - fax 1033) 773-B06 
S14. Japan • phone (0592] a9-7504 - fax (0S9S1 S4-97S3 
cPDwir-'c r'Aoh 



(continued from page 120) 

return NULL; 

) 

J else C 

return NULL: 

) 

BOOL —export KMetaCla86::CheckNextStrict( KFil 
{ 

ASSm{ k.attachea ) ; 

return KMetaClaaa: :LoadHext( f . ) = this: 

) 

BOOL .-export ffietaClase: :IsSubClaas{ char *naiD( 

// Relationship is 'receiver IsSubClaasOf n 

: ^ return TRUE; 

] else if ( m.super.class 1= NULL ) { 

return B-8uper_classr>lBSubClas5t name 
, ) else ( 

T8ACB( "KMetaClass::IsSubClass - »s is 



KMetaClass *\. ' k.class. 

KMetaCiassAlias »a = k_alia£, 
BOOL . f = FALSE; 

//ASSERK k.attached ) : 



if ( strcupC TO 
k E'indC i 
f = TRUE 

) else { 



ilfdef .DEBUG 



GRAF/DRIVE PLUS 4.5 
Printer /Plotter Graphics for DOS 



Publication-quality hard copy 
graphics for Microsoft-compatible C 
compilers, Borland C, and Borland 
Pascal, Borlarid progranimers use the 
same functions for screen and hard 
copy graphics, with almost no 
change to their source code. Also in- 
cludes Borland SVGA drivers with 
mouse support. You'll see our drivers 
in commercial software for desktop 
publishing, business charts, invest- 
ment analysis, maps, and science 
and engineering. 'Highly recom- 
mended'-M Dunleman, Dr. Dobbs. 

Full-resolution output to Laser- 
Jet. Epson & IBM dot matrix, 
DeskJet, DeskJet C olor, PaintJet, 
PostScript (mono/color), Canon laser 
& ink jet, Epson Stylus, HP plotters, 
color dot matrix, obscure printers too 
numerous to mention, PCX, TIF, DXF, 
WMF.BMP.AI.CGM. more file for- 
mats. (DTP addon req'd for file for- 
mats and less common printers.) 

l\^ore than 140 functions, 
including arc, bar. barSd, circle, 
drawfpoly, fillpoly. ellipse, fillellipse. 



line, outtext, pieslice, putpcx, 
putiniage, rectangle, sector, setcolor, 
setfillpattern, selfillstyle, setlinestyle. 
setpalette, settei^'ustify. seMewport, 
textheight. textwidth. 
. PrinttoLPT1-4.COM1-4ordisk, 
portrait or landscape, any size from 1 
inch to 5 feet • Use PostScript fonts 
on a PostScript printer • Use resident 
or downloaded fonts on a l^serJet • 
Use default and scalable stroke fonts 
on any printer • Print spooler • Print 
both vector and raster graphics • 
Scale, dither, and print PCX, TIFF, 
BlviP, Targa, GIF files, and screen 
dumps • Print without spawning a 
separate program (except Borland 
DPMI-32) • Print without clearing 
your graphics or text screen • Net- 
work-compatible • Does not require a 
graphics screen • Includes libs for 
real mode, 16-bit protected mode, 
and Borland DPMI-32. 

Personal License $149, Develop- 
ers with royalty-free distribution 
$299. DTP Drivers $99. 30-day m/b • 
guarantee. 



FLEMING SOFTWARE BOX 569 OAKTON, VA 22124 

(703)591-6451 



■ m.sub.class' = kc; 

) 

void ..export KMetaClass: :i 
m-siblirg.clasB ? 1 



B.claBS.iiaiie - clasB.nane; 
m.next.alia« - k.aiiaB.liBt: 
k.allasaiat - thi«; 



hSubClaBst KMetaClasa 'kc ) 



.achSibling{ KMetaaass tkc ) 



assAlias::~»letaClassAU«s( voiil ) 



Usring One 



ttuct CRUntimeClass 

^ *LPCsl?'^m!lpa«<:UsBSan!e; 

UINT m.wScheiiia: ' // scheoa mmiber 
void (PASCAL* a.pfnConstruct) (void* pj ; 
caiuntjuneClass* m_pBaseCla»6 ; 



* PASCAL LoadC 
S ar. UIHT* pwSchemaNum) ; ' 
:iiieCl«5s objects linked together in simple list 



CRuntimeClass* iii_pNexl 



Listing Two 

void ..atdcall CScribDoc::Construct(void* p) 



call CSctibDoc::_GetBaBeCla36() 



&CScribDoc::, 



11 &CScribDoe::clasECScribpoc: 



Listing Three 



;laeo CSmoUOhject : public CObject { 
EECLARE.SERIALtCSmallObject) ; 

DWORD n-value; // used to be unsigned short in vi 



if (ar.IsStoringO) 



e value is probably an ei 
id unsigned short 
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ENVIRONMENT VARIABLES 



listing One 



tihclude <stdio.h; 



gc, char ♦argvtl. 

»denv-. /♦ default ei 
Programjnyjron-ent , 



printfC'lsV-. envp;il): 
printf ("\nWl7idows default envj 
denv = GetDOSEnvirbmiehtf 
while (tdenv 1= NULL)' { 

printf <"%s\n". denv); 

denv *= stflraCdenv) 

) 



listing Two 



v.c: Build using Borland C++ EasyUin environmen' 
n calls. Copyright John "Fritz" Lovrey. 24 Hay, 
h that Bade it poaaible were done in conjunction 
n California University Computet Services Dept. 



I include <strii 
(define DEHO 



* LOADPARMS etucture ni 
truct IJDADPARMSI 

WORD segEnv ; 



/• child enviroiinent ' *, 
/• child coinand tail >i 
/» how to show child », 
/« must be mix *, 



fined on the SHELL line of CONFIG.SYS *, 



B the eiie of the environnent 



i, ESVSIZE)) « Nl 



if (ChNewEnv = GlohalAlloc (Gm ', Q 

if ((lpHewEnv'= GlobalL6ck(hMewEnv)) == NULL) 

/* we now have a pointer to the memory, fill it froin 
if (memcpydpNewEnv. GetDOSEnvironmint ( ) , ENVSIZE) = 



/• Sinple new getenvt) routine. Seach must be a 
LPSTR NewGetEnvdPSTR search) ( 
IfSTR topBtt; 



tmpstc = IpNewEnv: 
while^UnpEtrfe)^^ HULL) { 



tmpstr += BtrlenCtmpstr) < 
• if we fall through to here 



LPSTR'^^cUtrent: 
LPSTR tmpstr: 



'« the lable portion of putatr */ 

(continued on page 224) 
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QUICK and Ea^y installation. ^ 'Jl « . 

System Commander will have your PC ready to' add 
new operating systems in less than 5 minutes. Tt does not 
require repartitioning, iaor a partition of its own. - " 
^The first reboot brings up a menu of the operating 
systems already installed. Select the one ypu wanf an4 
System Commander does the rest. 
Saves You time and Effort. 

As you install new operating system';, System Com- 
mander saves thfrkey files,^uid adds the nevv; "OS to tfif 
Sy'sternComimnierx03^)ic^ \ ' 




System Commander makes it safe and easy to evalu- 
ate new operating systenas without giving up the 
reliability of your existing 0$. ' , 

Saves You Money! 

Instead of investing thousands of dollars in new PCs, 
you can now have as many as 100 operating systems oq 
one PC with up to 14 hard drives of any size or type. ; ^ 

System Commander is only $99.95 and comes with a 
60 day money-back, guarantee. For a limited time, get 
FREE overnight shipping when you mention this ad*.' 




Call now! 
1-800-648-8266 

60-DAY MONEY-BACK GUARANTEE 
V Communications, Inc 

NTW 4320 Stevens Creek Blvd.. Suite 1 20-DD 
\/ San Jose, CA 951 29 408-296-4224 
^ FAX 408-296-4441 

*Wheh ordered liefore noon PSt. Extra ctiarge lor Saturday delivery. Standard shippins outside US. 
CA residents add $7.25 sales tax. Offer subject to change without notice. All logos and product 
haines are tradOTarlis of Iheir respective cornparfes.VISA/IC/Arnex/CO^ -. 
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